home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 176-200 / scopedisk194 / nodeletev1.4 / nodelete.doc < prev    next >
Text File  |  1995-03-19  |  9KB  |  194 lines

  1.  *************************************************************************
  2.  *              NoDelete V1.4  (C) HooverSoft  Oct 30th, 1990            *
  3.  *************************************************************************
  4.  
  5. USAGE: 1> run NoDelete [extensions] [-p priority] [-y ypos] <ENTER>
  6.                        from CLI only.
  7.  
  8.  
  9.  
  10.  
  11.                                   HISTORY
  12.  
  13.                      CHANGES TO VERSION 1.35: OCT 1990
  14. Programmed  two  new options -O and -S (Cheers, John!).  These options sort
  15. of  "fix"  a  bug whith NoDelete which used to override the file protection
  16. bit.
  17.  
  18.                      CHANGES TO VERSION 1.3: SEP 1990
  19. Lots  of  changes.   Thinking  of  writing  a  new  documentation.  Anyway,
  20. introduced  command line options -p and -y for run-time setting of priority
  21. of NoDelete and of vertical position of titlebar.
  22.  
  23.                      CHANGES TO VERSION 1.2: AUG 1990
  24. Introduced  the  possibilty  to give multiple extensions on startup.  Lists
  25. extensions when pressing a key while Nodelete's titlebar is active.
  26.  
  27.                      CHANGES TO VERSION 1.1: Aug 1990
  28. NoDelete now automatically centers the Dragbar on Screen and calculates the
  29. correct width for the window if a extension is specified.
  30.  
  31. Now  works  fine  with  AmiOmega.   System won't crash if "Yes, Delete!" is
  32. selected.
  33.  
  34. Now  supports  the  use of extensions to ask confirmations only for special
  35. files  ending  in  defined  extension.  Will show the selected extension in
  36. window's titlebar.
  37.  
  38. NoDelete  now  checks  if  another  NoDelete is already active and exits if
  39. true.
  40.  
  41.                      CHANGES TO VERSION 1.01: Jul 1990
  42. Now handles protected Files correctly.  Previous version didn't complain if
  43. file was delete protected.
  44.  
  45. NoDelete sets its priority to a value of -5 directly after startup.
  46.  
  47.                     CHANGES TO VERSION 1.00: June 1990
  48. Version  1.01  now  restores  the  Dos Vector relative to _DosBase, so this
  49. program  should  work under Kickstart 1.3 as well.  If someone already uses
  50. Kick 2.0, he or she should let me know if NoDelete works with that.  I have
  51. heard  that  the  funny  instructions  in DosBase have been replaced with a
  52. regular jump table.
  53.  
  54.  
  55.                            WHY USE NODELETE?
  56. I  wrote  this  program  mainly  to  make  the fantastic public domain game
  57. "Omega"  more  enjoyable  to  play.   The author of this program thought it
  58. reasonable to have the system unlink the save-file after having reloaded it
  59. to  somehow  "simulate the continuity of character".  Too bad that NoDelete
  60. does not work correctly with this program...
  61. Footnote: It works now!
  62.  
  63.                               WHAT IT DOES
  64. NoDelete  enables  you  erraneous  humans  to  once  again  reflect  on the
  65. righteousness  of  your  decisions  concerning  the  deleting  of  files on
  66. AmigaDos devices.  If you try to delete a file or a program tries to remove
  67. it,  this  is  mostly  done  via  DeleteFile()  of  the  dos.library.  When
  68. executed,  NoDelete  bends  this  vector to its own routine which brings up
  69. this  cute  little requester on the active window.  This requester contains
  70. the  name  of  the file that the system is trying to delete.  If you really
  71. want  to  delete  this  file,  click to the "Yes, Delete!" gadget.  If not,
  72. click  to the "Oops, no way!"-Gadget of the requester.  NoDelete works just
  73. fine   with   aliases,   wildcards   etc.   For  problems  see  the  "known
  74. bugs"-section of this text.
  75.  
  76.                                 EXTENSIONS
  77. Lots  of  programs,  programmers  and normal people use extensions in their
  78. file system to be able to immediately make out the contents of a file.  For
  79. example,  ".c"  specifies  the file to be a C source code and ".bas" should
  80. contain  a  basic  program's  source.   There  are  tons of frequently used
  81. extensions,  from  ".asm"  up to ".cfg".  If you use NoDelete and you don't
  82. want  the  system to get on your nerves by confirming EVERY rm command, you
  83. should  use a certain extension on NoDelete's command line to tell NoDelete
  84. that  it  should  only  ask  confirmation for those precious ".c" or ".iff"
  85. files and let all others alone.
  86.  
  87. The command line
  88.  
  89.                1> run nodelete .c
  90.  
  91. would  tell NoDelete to only intercept the removing of files ending in ".c"
  92. and not to worry about any other files that are removed from the device.
  93.  
  94. You can specifiy up to ten extensions when running NoDelete. The command
  95.  
  96.                1> run NoDelete .c .iff .tex .asm
  97.  
  98. will  make  NoDelete  complain  about  any  file  which  ends in one of the
  99. specified  extensions  and  leave  all others alone.  If you have forgotten
  100. which  extensions  you  specified  at  startup,  just  activate  NoDelete's
  101. titlebar  and  press any key.  NoDelete will then give a list of extensions
  102. in the titlebar until another key is pressed.
  103.  
  104.  
  105.  
  106.                            COMMAND LINE OPTIONS
  107. Finally,  HooverSoft  is  proud  to have introduced command line options in
  108. NoDelete.  So far, four options are supported:
  109.  
  110. -p     number  where number is an integer between -20 and 9. If given on
  111.                                the command line, NoDelete will set its
  112. priority to this
  113.                                value.  If you type rubbish or use values not
  114. allowed, the
  115.                                default priority of -5 is set.
  116.  
  117. -y ypos                where ypos is an integer ranging from zero to 245
  118. (sorry,
  119.                                all you NTSC users...).  This number will
  120. determine the ver-
  121.                                tical position of NoDelete's titlebar.  if you
  122. try to fool
  123.                                NoDelete or do not give this option, the
  124. default value zero
  125.                                (top of screen) is used.
  126.  
  127. -O                             Override file protection bit. If this option is
  128. given,
  129.                                NoDelete will NOT care about the file's
  130. protection status.
  131.                                This option is sort of dangerous, but I think I
  132. you are
  133.                                explicitly asked wether you want to delete a
  134. file this
  135.                                should be presto! wiped off the disk without
  136. return or
  137.                                any other chance of survival..., Anyway, the
  138. default now
  139.                                is to consider and respect the file protection.
  140.  
  141. -S                             if given, this option tells NoDelete to shut
  142. up. No screams,
  143.                                no comments!
  144.  
  145.                                KNOWN BUGS
  146. NoDelete  cannot  take  care of the AmigaDos command Delete.  God knows how
  147. this command erases a disk file...
  148.  
  149. The  Shell  won't complain if you try to delete any non-existent file while
  150. NoDelete  has  its  grip  on  the system.  This is not really a bug because
  151. NoDelete  works  on  this  basis  of  cheating  the  calling  function  and
  152. pretending that everything is just fine and deleted. This also is the cause
  153. that the calling program will not be informed if the file in question
  154. is delete protected.
  155.  
  156. Sometimes  it is possible to get two copies of NoDelete running at the same
  157. time.   I  can't  explain  how  this is to be done, but somehow it works...
  158. Anyway this happens very seldomly.
  159.  
  160.                             THE LEGAL STUFF
  161. NoDelete  is  Public Domain and may be copied freely by everyone except for
  162. purposes  listed below as long as this notice is left intact.  This program
  163. is  copyright  (C)  by  HooverSoft.   It  may  NOT  be  copied  or sold for
  164. commercial  purposes  without  written  permssion  by the author (Get lost,
  165. Carsten Wolf and all you other suckers!).  It may be distributed and copied
  166. freely for non-commercial purposes only.
  167.  
  168. When  distributed,  this program should always be accompanied by this file,
  169. the documentation.
  170.  
  171.                     FURTHER PLANS & HOPELESS DREAMS
  172. I  would  like  to use CreateTask() to launch a separate Task for Nodelete.
  173. This would unlink NoDelete's memory requirements from the current stacksize
  174. of  the  system.  It would be nice if "delete" could also be disabled but I
  175. am not sure how to do this.
  176.  
  177.                             PUBLIC FEEDBACK
  178. Bug  reports  (cheers, Jensi & John!), criticism, comments and approvements
  179. should be sent to
  180.                                                
  181.                                SNAIL:
  182.                               HooverSoft Inc.
  183.                             Joellenbecker Weg 4
  184.                                4900 Herford
  185.  
  186.                                BITNET:                 
  187.                           hoover@math4.uni-bielefeld.de
  188.  
  189.                                 DISCLAIMER
  190. Do  whatever you like with this program, but listen:  you can't blaim it on
  191. me if anything goes down the drain! 
  192.  
  193. Have fun & God bless you, Hoover
  194.